Determines the default volume and default directory.

OSErr PBGetVolAsync (
    ParmBlkPtr paramBlock
);

paramBlock

A pointer to a basic File Manager parameter block.

function result

A result code.

DISCUSSION

The relevant fields of the parameter block are:

• ioCompletion

  On input, a pointer to a completion function.

• ioResult

  On output, the result code of the function.

• ioNamePtr

  On output, a pointer to the name of the default volume. If you do not wish the name of the default volume returned, pass NULL in this field.

• ioVRefNum

  On output, a volume reference number or a working directory reference number.

If a default directory was set with a previous call to PBSetVolAsync, a pointer to its name is returned in ioNamePtr and its working directory reference number is returned in ioVRefNum. However, if, in a previous call to HSetVol (or PBHSetVolAsync), a working directory reference number was passed in, PBGetVolAsync returns a volume reference number in the ioVRefNum field.

AVAILABILITY

Not supported in Carbon. Not available in Carbon.

CARBON NOTES

Obsolete. Use PBHGetVolAsync instead.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)